@travetto/compiler

travetto: Compiler

This module expands upon typescript, with supplemental functionality:

• Read tsconfig.json from the project directory to provide
• Supports on-the-fly compilation, nothing needs to be compiled ahead of time
• Enhanced AST transformations, and transformer registration
  • All AST transformations are single-file based, and runs without access to the TypeChecker
• Intelligent caching of source files to minimize recompilation
• Support for detecting changes in sources files at runtime
• Allows for hot-reloading of classes during development
  • Utilizes es2015 Proxys to allow for swapping out implementation at runtime

Additionally, there is support for common AST transformation patterns to facilitate all the transformers used throughout the framework. Transformations are defined by support/transformation.<name>.ts as the filename. The schema for a transformer is:

  export class CustomerTransformer {
    after: ['base'],
    phase: 'before'|'after', // The phase as defined by Typescript's AST processing
    transformer: (context: ts.TransformationContext) => {
       return (file: ts.SourceFile) => {
         ... modify source file ...
         return file;
       }
    }
  }